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SOFTWARE CONTROL OF THE DISK II OR IWM CONTROLLER 

Each of the eight expansion slots of the Apple II computer has the exclusive 
use of sixteen memory locations for I/O control. These memory locations can 
be used as software switches. A software routine can instruct the Interface 
card in a particular slot to perform a predefined hardware task by toggling a 
software switch. Whenever the Apple II addresses one of the sixteen I/O loca- 
H°°! allocated to a particular slot, the signal on pin 41 of that slot, called 
DEVICE SELECT/, switches to the active low state. This signal, in conjunction 
with the four low-order address lines (AG - A3), can be used to enable logic 
in the peripheral card to perform a particular task. The following table 
illustrates the memory space for the sixteen I/O locations for each expansion 
slot. 

TABLE 1: PERIPHERAL CARD I/O SPACE 



SLOT 



LOCATIONS 




1 
2 

3 
4 

5 
6 

7 



$C080 
$C090 
$COAO 
$COBG 
$COCO 
$CODO 
$COEO 
SCOFO 



$C08F 
SC09F 
$COAF 
$COBF 
$COCF 
$CODF 
$COEr 
$COFF 



One common method of accessing peripheral card I/O control softswitches through 
software is to use the Apple's (6502) indexed addressing mode. For example, 
a LDA SC080, X instruction can be used to access Softswitch in any slot. If 
the index register X is loaded with a value equal to the slot number times 
sixteen. 

Sixteen peripheral I/O addresses are used t.o control the functions of the disk 
II controller, the following table illustrates the functions of the sixteen 
software switches. 



TABLE 2; DISK II CONTROLLER SOFTSWITCHES 



ADDRESS 



$C080, X 
$C081, X 
$C082, X 
$C083, X 
$C084, X 
$C085, X 
$C086, X 
$C087, X 
$C088, X 
$C089, X 
$C08A, X 
$C08B, X 
$C08C, X 
$C08D, X 
$C08E, X 
$C08F, X 



2/6 



FUNCTION 


PHASE 


OFF 


PHASE 


ON 


PHASE 


1 OFF 


PHASE 


1 ON 


PHASE 


2 OFF 


PHASE 


2 ON 


PHASE 


3 OFF 


PHASE 


3 ON 


TURN MOTOR OFF 


TURN MOTOR ON 


SELECT 


DRIVE 1 


SELECT 


DRIVE 2 


Q6L 




Q6H 




Q7L 




Q7H 





Software Control of Disk II or IWM Controller -- May 10, 1984 



Page 0003 of 0009 



Apple ][ Computer Information -- IWM Disk I/O Controller Information 

The index register X has the value of slot number times 16. The last four 
addresses have the following functions. 

Q6 Q7^ FUNCTION 

L L READ 

H L SENSE WRITE PROTECT OR PREWRITE STATE 

L U WRITE 

H H WRITE LOAD 

In general, any valid 6502 instruction can be used to access the above soft- 
switch address, except a load instruction is used to read a byte of encoded 
data from the controller and a store instruction is used to write a byte of 
encoded data to the controller. Below are typical examples demonstrating the 
use of the disk II controller softswltches. It is assumed that both Q6 and 
Q7 are low at the beginning of the read/write examples. 

SELECT DRIVE 



LDA $C08A, X SELECT DRIVE I 

LDA $C08B, X SELECT DRIVE 2 



The hardware design of the controller allows only one drive to be selected at 
one time. A LDA $CC8A, X instruction will select drive 1 and deselect drive 
2. A LDA $C08B, X instruction will select drive 2 and deselect drive 1. 

MOTOR ON 

LDA $C089, X TDRN MOTOR ON 

LDA $C088, X TURN MOTOR OFF 

It should be noted that there is only one interface signal (ENABLE/), going 
from the controller to each floppy disk drive, which is used to enable the 
drive's read/write function and to turn on the motor. Both the select drive 
and the motor on Instructions must, be executed in order to activate the ENABLE/ 
signal of a partl/iular drive. A typical program will select the drive first 
and then turn on the motor at a later time. After the completion of the motor 
on instruction, the program should wait at least 1 second for the motor to come 
up to speed, before read/write functions can be performed reliably. 

The disk II controller hardware will keep the ENABLE/ signal to its active low 
state for approximately one second after the execution of the motor off in- 
struction, therefore read/write can be performed reliably within this period. 
To be on the safe side, the program should verify that the motor is spinning 
by monitoring the change in data pattern read from the drive. This delay 
in turning off the motor facilitate rapid and repeat access to the same drive. 

SENSE WRITE PROTECT 

LDA q6H, X WRITE PROTECT SENSE MODE 

LDA Q7L, X READ CONTROLLER STATUS REG. 

BMI WRPROT BRANCH IF BIT 7 OF STATUS REG. IS HIGH 

The above instruction will load the content of the controller's status reg- 
ister into the accumulator. Bit 7 of the status register is the write protect 
flag. A "one" in bit 7 of the status register indicates that a write protected 
diskette is inserted into the drive. A BMI instruction will check the write 
protect flag. The program will branch to the WRPROT address label if the 
write protect flag is set. 
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READ A DATA BYTE 



LDA Q7L, X 
LOOP LDA Q6L, X 
BPL LOOP 



MAKE SURE IN READ MODE 

READ THE BYTE 

STAY IN THE LOOP IF THE M.S. BIT IS LOW 



LP LDA Q6L, X READ ANOTHER BYTE 

BPL LP SAY IN THE LOOP IF THE M.S. BIT IS LOW 



NOTE: THERE SHOULD BE NO PAGE CROSSING FOR THE BPL INSTRUCTIONS. 

The LDA Q7L, X instruction makes sure that the controller Is in read 
mode. The LDA Q6L, X instruction loads the contents of the controller's 
data shift register into the accumulator. Since the Apple OCR code requires 
that the most significant bit of every encoded data byte is high, the BPL 
instruction will force the program to stay in a two instruction loop until 
the M.S. bit of the controller data shift register is high. At the beginning 
of every byte time, the controller internal logic will clear the data shift 
register. As data bits are shifted into the data shift register, the M.S. 
bit of the register is high, if and only if a full byte of data is assembled 
in the register. The data byte will stay in the register for a little more 
than 7 us. Therefore, It is important to make sure that the BPL instruction 
does not cross the page boundary. This is necessary to ensure that the exe- 
cution time of the two instruction loop (LDA, BPL) is no more than 7 us. 

WRITE A DATA BYTE 



EXECUTION TIME 
OF THESE INSTRUCTIONS . 
MUST BE EXACTLY 
32 CLOCK CYCLES 

I STA 

LDA 



LDA Q6H, X GO TO 

LDA Q7L, X PREWRITE STATE 

LDA DATA 

STA Q7H, X PARALLEL LOAD DATA INTO CONTROLLER 

LDA Q6L, X CONTROLLER SHIFT DATA OUT SERIALLY 



Q6H, X PARALLEL LOAD ANOTHER BYTE 
Q6L, X SHIFT OUT DATA 



LDA Q7L, X OUT OF WRITE MODE 
LDA q6L, X TO READ MODE 

NOTE: It is Important to write a garbage byte (HEX FF) before turning 
off the write mode, so that the drive electronics has enough time 
to write the last valid data byte. 
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The first two instructions force the controller into the prewrite state. These 
are the same instructions to sense the write protect flag. It is important 
to execute these two instructions even the programmer does not want to sense 
the write protect flag. The STA instruction loads the contents of the accum- 
ulator Into the controller's data shift register. The next instruction [LDA 
Q6L, X] causes the data in the register to shift out serially. Q6H and Q7H 
are the conditions required for parallel loading the data into the controller. 
Shifting out the data serially to the disk, drive requires Q6L and Q7H. The 
first STA instruction sets Q7 high, because the conditions are Q6H and q7L 
before executing this instruction. The conditions are Q6L and Q7H before the 
second STA instruction, therefore the second STA instruction sets Q6H. 

The execution time of the instructions between the end of two consecutive 
parallel load instructions [STA] has to be exactly 32 clock cycles, otherwise 
invalid data will be written on the diskette. In order to calculate the exe- 
cution time, it is important to note that the 6502 processor requires one 
additional execution cycle for branching or indexing operations crossing the 
page boundary. The program should switch the controller back to the read mode 
after all the data has been written. 



WRITE SELF SYNC BYTE 



EXECUTION TIME 

OF THESE INSTRUCTIONS 

MUST BE EXACTLY 

40 CLOCK CYCLES 

I 



LDA 
LDA 
LDA 
STA 
ORA 



Q6H, X 
Q7L, X 
#$FF 
Q7H, X 
Q6L, X 





STA 
ORA 

* 


Q6H, X 


SELF SYNC BYTE 


Q6L, X 


40 CLOCK CYCLES 

r 


ft 






• 

LDA 


DATA 




STA 
" LDA 

• 


Q6H, X 


DATA BYTE 


Q6L. X 


32 CLOCK CYCLES 


* 






STA 
~ LDA 

• 


Q6H, X 




Q6L, X 




• 

LDA 
LDA 


Q7L, X 
Q6L, X 



PARALLEL LOAD AUTO SYNC BYTE 
START TO SHIFT OUT AUTO SYNC BYTE 
ORA IS USED SO THAT LDA #$FF IS NOT 
NEEDED TO WRITE THE NEXT SYNC CYCLE 



PARALLEL LOAD ANOTHER AUTO SYNC BYTE 
SHIFT OUT SYNC BYTE 



LOAD FIRST DATA BYTE 
SHIFT OUT DATA BYTE 



NOTE: 



OUT OF WRITE MODE 
TO READ MODE 



Write a garbage byte (HEX FF) before turning off write mode. 
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The Apple GCR code uses a unique synchronization technique to determine the 
byte boundary. A self sync byte consists of eight bits of "1" and two bits 
of "0," The procedure to write a sync byte is the same as to write a data 
byte, except that the execution tltae of the instructions between the end of 
two consecutive parallel load sync byte instructions has to be exactly 40 us. 
During the write sync byte time, the processor loads eight bits of "1" into 
the controller. After shifting out 8 bits of "1", the controller hardware 
will shift out "0" until the next parallel load instruction. Since there are 
40 us between two consecutive parallel load instructions and a 4 us bit time, 
8 bits of "1" from the processor and 2 bits of "0" appended by the controller 
hardware are shifted out to the drive. It is necessary to write at least five 
self sync bytes at the beginning of both the address and data field. 

READ SELF SYNC BYTE 

Due to the Apple GCR code's unique synchronization technique, the controller 
hardware will determine the byte boundary automatically. The following is a 
brief description of the Apple synchronization technique. 

FIGD5E 1; SYNCHRQWIZATIOS PROCESS 



1ST 
SYNC BYTE 



5TH 
SYNC BYTE 
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iiiii Uiooiiiiiiiiooii^iiiiioq^iiiiiip o iiiiiiii^ oo 
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In the above diagram, each row of brackets represent what the controller will 
send out to the Apple II should the controller start reading at any given bit 
in the first self sync byte. The controller groups the self sync read data 
streamlnto 8-bit byte with a "I" in the most significant bit of each byte. 
Any "O" bit between bytes are dropped out. From the above diagram, it is shown 
that the controller is able to group the data at the correct byte boundary 
within five byte time after the beginning of the read. This is always true 
for any bit position to start the reading. Therefore, a minimum of five self 
sync bytes are required for the controller to sync on the read data. After 
the fifth self sync byte, the controller has established the byte boundary and 
is able to read the data following the sync bytes correctly. The "D5 AA 96" 
and "D5 AA AD" address mark sequences follows the self sync bytes in the 
address and data field respectively. It Is not necessary to read and verify 
the sync byte. Ih order to read/write a sector, the program should look for 
the "05 AA 96" sequence which are the address mark bytes for the address field. 
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The D5 and AA patterns are reserved for address mark. These patterns are act 
used to encode data. Therefore, byte syncronlzation for the address field is 
achieved by searching for the "D5 AA 96" sequence. Byte synchronization for 
the data field is done by looking for the "D5 AA AD" sequence. 

SEEK TO ANOTHER TRACK 

The stepper motor in the Disk II is a four phase stepper motor. Eight I/O 
control softswitches are used to toggle the four phase on and off as shown in 
table 2. Two adjacent phases have to be activated in sequence in order to 
move the R/W head to the adjacent track. Activating the phases in ascending 
order (0, 1, 2, 3, 0, 1, ,..) moves the head towards (inward) the center of 
the diskette. The head moves away (outward) from the center of the diskette 
when the phases are activated in descending order (3, 2, 1, 0, 3, 2, ...). 
All even numbered tracks are positioned under phase and all odd numbered 
tracks are under phase 2. In order to step in a track, the phase 1 and then 
phase 2 have to be activated in sequence from an even numbered track, while 
the phase 3 and then phase is activated in sequence from an odd numbered 
track. The phase 3 and then phase 2 sequence is used to step out a track from 
an even numbered track. For stepping out a track from an odd numbered track, 
the phase I and then phase sequence Is used. The spindle motor should be on 
for 150 ms before starting the seek operation. The following is an example to 
step in a track from an even numbered track. 

LDA $C083, X TURN ON PHASE 1 



11. 



LDA $0085, X TORN ON PHASE 2 



0. 



LDA 



36. 



msec delay loop 



msec delay loop 



?C084, X TURN OFF PHASE 1 



msec delay loop 



LDA $C086, X TURN OFF PHASE 2 

The above programming example is used to illustrate the timing required to 
step in a track from an even numbered track. The user may use a indexed look 
up table for the parameter required for different delay loops. No matter how 
many tracks to step, the user has to allow the last phase to be on for 36.6 msec 
because this timing includes the head settling time requirement (23 ms) of the 
drive. For long seek (step a number of tracks), two adjacent phases can over- 
lap the phase on time in order to increase the torque of the stepper motor 
and to reduce the seek time. Since the timing between the phase ON/OFF time 
Is critical, it is recommended that the user calls upon the SEEK routine in 
the Apple DOS for seeking. Figure 2 shows the waveforms of the phases to seek 
from track to track 9. 
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